home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / mftp / mftp.doc < prev    next >
Text File  |  1995-08-31  |  13KB  |  368 lines
  1.  
  2.  
  3.  
  4.                                        ffffff      tttt
  5.                                      fffffffff    tttt
  6.                                     ffff   ff    tttt
  7.            mmmm    mmm    mmm      ffff   ff  tttttttt   pppppppppppp
  8.           mmmmmmmmmmmmmmmmmmm     ffff       tttttttt   pppppppppppppp
  9.          mmmmmmmmmmmmmmmmmmmm    ffff         tttt     ppppp      pppp
  10.         mmmmmm  mmmm   mmmmm  ffffffff       tttt     pppp       pppp
  11.        mmmmm   mmmm    mmmm  ffffffff       tttt     pppp       pppp
  12.       mmmmm   mmmm    mmmm    ffff         tttt     ppppppppppppppp
  13.      mmmmm   mmmm    mmmm    ffff         tttt     ppppppppppppppp
  14.     mmmmm   mmmm    mmmm    ffff         tttt     pppp
  15.    mmmmm   mmmm    mmmm    ffff         tttt     pppp
  16.  
  17.  =============================================================
  18. =============================================================
  19.  
  20.    Version 1.27         © by Michael Neuweiler  1994 - 1995
  21.    25th August 1995            email: dolphin@zool.unizh.ch
  22.  
  23.  
  24.  
  25. Copyrights:
  26. ===========
  27.  
  28. I know nobody reads this section (as I do).. but I can't help ;-)
  29. Anyway it's short. This program is shareware - what means anyone
  30. can use it as long as he/she doesn't gain profit out of it and
  31. the usage has nothing to do with military or other stuff which might
  32. endagnger other people/animals. (don't call me communist, now ! ;-)
  33. You can use the program for free for as long as you wish but if you
  34. want to get rid off the requester, send 10$ or similar to the address
  35. at the bottom of this document and you'll receive a key-file.
  36. The program is not crippled in any way. All features are available
  37. without the key.
  38.  
  39.  
  40.  
  41. Introduction:
  42. =============
  43.  
  44. mftp 1.27 is an ftp client proram for the AmiTCP protocol stack.
  45. It has a very nice GUI which is realized with MUI (see below).
  46. Useful features as directory caching, adjustable transfer buffer size
  47. and a lot more... You have to try out by yourself or continue reding
  48. this text.
  49.  
  50.  
  51.  
  52. Requirements:
  53. =============
  54.  
  55. - Amiga 500 - 4000
  56.  
  57. - Memory: When AmiTCP is running, about 100kB should be enough.
  58.  
  59. - Kickstart 2.1 or better
  60.  
  61. - AmiTCP 3.0 or better (maybe 2.3 works too.. never tried it)
  62.    © 1994 by Network Solution Development Inc, Finnland
  63.    available on AmiNET or other sites.
  64.  
  65. - MUI 2.2
  66.    © 1992-94 by Stefan Stunz
  67.    available on AmiNET or other sites.
  68.  
  69.  
  70.  
  71. Installation:
  72. =============
  73.  
  74. Copy the executable to a path of your choice.
  75. If the file 'mftp.key' is included, copy it to 's:'
  76.  
  77. That's it ! Damn straightforwad, isn't it ?
  78.  
  79. You can start it from CLI or Workbench... as you wish
  80. A yeah, to be on the save side I would use a stack size of
  81. at least 5000.
  82.  
  83.  
  84. Description:
  85. ============
  86.  
  87. When you start mftp a window should appear. (If not, try to start it
  88. from CLI to get an error report.) This window can be divided in four
  89. sections: left, middle, right and lower.
  90.  
  91. - On the left side you find a string Gadget that contains the current
  92.   directory on your computer. You can click on the icon to its right to
  93.   get a drive list.
  94.   Below it you'll find the directories and the files in this directory.
  95.   Double click on a directory to enter it. If you double click on a
  96.   file you start the filetransfer (only possible when connected).
  97.  
  98. - In the middle row there are a lot of gadgets:
  99.  
  100.   ascii  :  Selects the file transfer mode ASCII or BINARY. If you
  101.   bin       select 'auto' mftp will use the later descibed feature to
  102.   auto      recognize automatically if ascii or binary mode should be
  103.             used.
  104.  
  105.   --->   :  Chose active list (left/local or right/remote).
  106.   <---      The following gadgets have only affect on the side where
  107.             the arrow points away from.
  108.  
  109.   parent :  Go to parent directory.
  110.  
  111.   refresh:  Refresh the directory. If the right (remote) directory
  112.             is active mftp will clear the directorie's cache and get
  113.             it from the remote host again.
  114.  
  115.   mkdir  :  Create a directory
  116.  
  117.   rmdir  :  Remove selected directory
  118.  
  119.   copy   :  Copy the selected file(s). They are copied in the direction
  120.             of the arrow (above).
  121.  
  122.   rename :  Rename selected file(s)
  123.  
  124.   delete :  Delete selected files(s). You will be prompted if you
  125.             really want to do this unless you didn't deselect
  126.             'confirm delete' in the setup menu.
  127.  
  128.   view   :  Start 'More' or the pager you've set under 'env:PAGER' to
  129.             view the contents of a file. Files on the remote host will
  130.             be transferred automatically.
  131.  
  132. - The stuff on the right is equal the the one on the left except that
  133.   it is dedicated for the directories and files of the remote host.
  134.   Also there is no gadget for the drives.
  135.   This side will be disabled as long as you're not connected to a
  136.   remote host.
  137.   To change a directory manually you can enter it into the string
  138.   gadget.
  139.  
  140. - On the bottom you find five gadgets:
  141.  
  142.   Connect :  Opens a requester to enter data which will be used to
  143.              connect to a remote host.
  144.  
  145.   Close   :  Close a already existing connection.
  146.  
  147.   Setup   :  Open a Window that will allow you to change the default
  148.              settings.
  149.  
  150.   About   :  Shows information about the author if this program.
  151.  
  152.   Exit    :  Exits the program. If you're connected it will ask you
  153.              wheter to disconnect from the remote host or to stay.
  154.  
  155.  
  156. The Connect-Requester :
  157. -----------------------
  158.  
  159. When you click on 'Connect' the connect requester will open. There you
  160. can enter the address of the host, the username, password and
  161. eventually the account information (usually not needed).
  162. There is also the possibility to enter a starting directory which will
  163. be selected as soon as the connection is up.
  164. For anonymous login you can simply click on 'anonymous' and mftp will
  165. try to login as 'anonymous' and the email address (you hav to set it in
  166. the setup) as password.
  167. The top field is not needed unless you define Hosts in the setup and
  168. save them (see below).
  169.  
  170. Click on 'OK' to try to get a connection to the given host. A status
  171. information will appear and inform you about the progress.
  172.  
  173.  
  174. The Setup-Requester:
  175. --------------------
  176.  
  177. It is divided into three pages which can be selected with the gadget on
  178. the top. On the first page you will find theese gadgets:
  179.  
  180.  Email address :  Enter your email address here. It will be used as
  181.                   password when you login as anonymous.
  182.  
  183.  Default transfer: Set which transfer type you want to use when you
  184.                    start mftp the next time.
  185.  
  186.  Treat link as.. : Select wheter you want links on the remote host to
  187.                    be listed as files or directories.
  188.                    Unfortunately there is no way to check this
  189.                    automatically. If directory-links appear in the file
  190.                    list or vice versa you can change this selection and
  191.                    refresh the remote directory.
  192.  
  193.  Show ftp output : If selected there appears a list in the main window
  194.                    with all the responses we get from the remote host.
  195.                    If you use NTSC 600x200 you might want to deselect
  196.                    it so MUI won't switch to a smaller (unreadable)
  197.                    font.
  198.  
  199.  Confirm delete  : If selected you must confirm everytime when you want
  200.                    to delete something. Otherwise every 'delete' or
  201.                    'rmdir' will delete IMMEDIATELY.
  202.  
  203.  Log ftp messages: currently not supported.
  204.  
  205.  Transfer Bell   : Rings every time a transfer is complete.
  206.  
  207.  Auto update     : Always updates the listing when you change the
  208.                    remote host (should usually be on). When deselected
  209.                    You have to do a manual 'refresh' every time you
  210.                    change a directory or connect to a host.
  211.  
  212.  Directory caching: Enables directory caching. This way if you change
  213.                     to a directory you have been before mftp doesn't
  214.                     need to get the entire filelist from the remote
  215.                     host. mftp uses a directory in 'T:' to save
  216.                     every directory. (If you run out of memory you
  217.                     might want to delete theese files (NOT the
  218.                     directory) because mftp doesn't check if there is
  219.                     still room.
  220.                     If enabled it speeds up changing directories a lot!
  221.  
  222.  Transfer Buffer  : Lets you set the size in bytes of the transfer
  223.                     buffer. It is used while receiving and sending
  224.                     files. If you feel mftp accesses you disk too often
  225.                     while transferring, just enlarge the buffer.
  226.                     mftp will access the disk always when 'x' bytes are
  227.                     received.
  228.  
  229.  History lines    : Set the amount of lines which will be displayed 
  230.                     in the history window (ftp output). If you're
  231.                     short with memory I suggest not to use a value
  232.                     higher than 50.
  233.  
  234. On the host page of the seupt requester you can predefine host which
  235. will be later easily accessible in the connect requester (roll down
  236. menu). Click 'new' to define a new host. The connect requester will
  237. appear and lets you enter all the necessary data (see 'connect
  238. requester). When you're finished, simply click 'OK'. Don't be afraid,
  239. this way you won't get connected. The just made entry will appear in
  240. the list. You can 'edit' it later again or move it 'up' and 'down'.
  241.  
  242. On the 'Auto recon' page you can predefine file-patterns which will be
  243. used to determine wheter to use binary or ascii transfer mode. This has
  244. only an effect when you selected 'auto' as transfer mode.
  245. Standars Amiga wildcards are understood (as * #? ? and other).
  246. Entering data is quite strightforward so I'll just give you an example
  247. list :
  248.  
  249.     binary patterns :                    ascii patterns :
  250.  
  251.     *.lha                                *.txt
  252.     *.lzh                                *readme
  253.     *.zip                                *.doc
  254.     *.exe
  255.  
  256. and so on. You can check in the history window which mode has been
  257. selected: e.g. 'Match in BINARY pattern list' will appear then mftp
  258. will use binary mode.
  259.  
  260.  
  261. On the bottom of the setup requester there are always three gadgets:
  262.  
  263.  Save  :  Save the corrent settings to envarc:mftp.config and to
  264.           env:mftp.config.
  265.           It will also save all window positions and sizes. So mftp
  266.           will appear in the same look after the next reboot.
  267.           The current directory on the local (your) machine will also
  268.           be saved so the next time you start mftp you are back in your
  269.           donload directory or whatever.
  270.  
  271.  Use   :  Only use theese settings temporarely. If you make a reset
  272.           mftp will use the last 'saved' settings.
  273.  
  274.  Cancel:  Abort any changes and reload the last 'used' settings.
  275.           It will also jump back to the last 'used' or 'saved'
  276.           directory.
  277.  
  278.  
  279.  
  280. If you have any problems using mftp feel free to email me.
  281.  
  282.  
  283. Registration:
  284. =============
  285.  
  286. Send a monney order, a 10$ bill or simmilar to:
  287.  
  288. Michael Neuweiler                  email: dolphin@zool.unizh.ch
  289. Hauriweg 6
  290. 8038 Zurich
  291.  
  292. Switzerland
  293.  
  294. and you'll get a key file which makes the requester disappear. 
  295. I'll send it preferably by email ! If I shall send you a disk please
  296. insert also an envelope with the right postage on it.
  297.  
  298. I know some might say.. "bah, why send him 10$ if mftp works anyway."
  299. Well I, I spent a lot of time programing this piece. I even had to
  300. completely rewrite it because there was a bug which made A4000 crash
  301. and which was not found (now I know what it was... Cheers, Stefan ! :-)
  302.  
  303. If you have any suggestions what else could be included, please email
  304. me !
  305.  
  306.  
  307. To do:
  308. ======
  309.  
  310. I know a lot of you want this thing to be localized. I'll do it maybe
  311. but now (august 1995) I've got to concentrate on biology again -
  312. because thats what I should study (and not autodocs of Mui :-)
  313.  
  314.  
  315. Known Bugs:
  316. ===========
  317.  
  318. The Abort sequence in the Connect-Status window doesn't work very well
  319. yet. It still takes some time sometimes to abort.
  320.  
  321. When you transfer a file which is in fact a link to another file in
  322. another directory (e.g. all files in aminet/recent) then mftp is
  323. not able to get the correct filesize and it uses the size of the link
  324. (e.g. 23 bytes) which has the effect that the transfer status
  325. shows 100% during the whole transfer. This is not a BUG !
  326.  
  327.  
  328.  
  329. ------------------------------------------
  330.  
  331.  
  332.  
  333.                           This application uses
  334.  
  335.  
  336.                         MUI - MagicUserInterface
  337.  
  338.                 (c) Copyright 1993/94 by Stefan Stuntz
  339.  
  340.  
  341. MUI is a system to generate and maintain graphical user interfaces. With
  342. the  aid  of  a  preferences program, the user of an application has the
  343. ability to customize the outfit according to his personal taste.
  344.  
  345. MUI is distributed as shareware. To obtain a complete package containing
  346. lots of examples and more information about registration please look for
  347. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  348. your local bulletin boards or on public domain disks.
  349.  
  350.           If you want to register directly, feel free to send
  351.  
  352.  
  353.                          DM 30.-  or  US$ 20.-
  354.  
  355.                                   to
  356.  
  357.                              Stefan Stuntz
  358.                         Eduard-Spranger-Straße 7
  359.                              80935 München
  360.                                 GERMANY
  361.  
  362.  
  363.  
  364. --------------------------------------------
  365.  
  366.   AmiTCP/IP is propiertary, copyrighted product of the NSDi - Network
  367.   Solutions Development Inc, Finland.
  368.